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How to Install Franklin Editor 



L Create a franklin directory in a location of your choice on your hard drive. These instruction assume 
you create C:\franklin\ 

2. Download the self-extracting FranklinEditor from 

http : // monolith. adtech.internet. ibm . com/ franklin/do wnloads/FranklinEditor . exe . Save the file to a 
temporary directory "on you hard drive. 

3. Double-click on FranklinEditor.exe in the temp directory on you hard drive. This will start the 
WinZip Self-Extractor. Under "Unzip to folder" enter C:\franklin\ or the path to the franklin directory 
you created in Step 1. Click on "Unzip". 

4. Go to C:\franklin\FranklinEditor on your hard drive. Open franklin.properties file in NotePad. If 
the location of your browser is different from the one listed, remove the # in front of browserPath and 
change the value to the appropriate path on your machine. Save and close the file. 

5. Double-click on C:\franWin\FranklinEditor\FranklinEditor.bat file. The login screen will popup 
and prompt for your username and password which the Franklin team has provided to you. 



How to Delete Franklin Editor 



1. Simply delete the franklin directory you created on your hard drive. 
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How to Get Started with Franklin Editor 

After installing the Editor by following the How To Install instructions and logging in, you can take the 
actions listed below. When Franklin runs integrated with the KittyHawk workflow engine, a user can 
work in one of two modes: superuser or regular user . 

Note: 

All icons in the Editor UI display a tooltip if you mouse over the icon. 
Useful error messages appear in the status bar at the bottom of the Editor UI. 

ACTIONS FOR SUPERUSER 

Search 

Click on the "Search" icon above the Active List. This brings up the Search UL Select attributes and 
values from the drop down menus. You can add more search conditions using the +/- widget. Click on 
"Submit" to launch the search. 

Hint: A search that will always bring back results is "Page Type is Fragment" 

Once search results are displayed in the table, you can select one or more of them and merge them into 
the Active List in the Editor UI by clicking on the "Merge with Active List" icon I 



ICheck Out for Edit 



Select an item in the Active List and click on the "Checkout selected document" icon. If the document is 
not locked by another user, it will appear in the right-hand pane in editable widgets. You can modify any 
-fields. and resubmit into Franklin server. See "Check in" 

Mcheck Out for View 

Select an item in the Active List and click on the "View selected document in read only mode" icon. It 
will be displayed in the right-hand page in editable widgets. However, you will not be able to check-it in 
with any changes. You can click on the "Check out" icon above the right-hand pane to check it out for 
edit. 



LJcreate New Fragment 

Click on the "Create new document" icon. This brings up the list of fragments and pages you are 
allowed to create. Select a fragment, click on "Create". The Editor UI retrieves the correspondig DTD 
from the server and auto-generates the right-hand pane with widgets. The required fields are highlighted 
in yellow, and must be filled in before you are allowed to check in the document. 
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Create a New Page 



Create a page the same way you create a fragment. However, note that a page has additional fields that 
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enable it to be turned into a final HTML page and previewed: 

A page includes one or more subfragments. To include a subfragment into a page under construction, 
do the following: 

• Search for all subfragments of the appropriate document type (see Search), and merge them into your 
Active List 

• Select the subfragment you wish to include from the Active List 

• Click on the "Copy" icon above the Active List (3l 

• Click on the subfragment field in the page under construction 

• Click on the "Paste" icon above the right hand pane. tHi This will write the fragment ID of the pasted 
fragment into the field. 



A page requires "Publishlnfo" to be filled in. You must select a publish directory on the server. This 
is where the final page will be saved. You must also enter the final HTML file name for the published 
page. You must also select a style sheet to render the page in HTML. 

See "Preview" to view the final HTML page. 
Check in 




Once you have created a new document or modified an existing one, click on the "Check in document" 
above the right-hand pane. The document will be validated against the DTD and sent to the Franklin 
server. You can now search for it to check it out again for modifications. 



l2i3Preview a Page 

Before checking in a page, you can preview it by clicking on the "Preview page" icon above the right- 
hand pane. It will launch the browser you specified in the /r anklin.properties file during installation. The 
browser will display the output HTML generated using the style sheet listed in the first PUBLISHINFO 
of the page. To see all output pages, you need to check : in the page and then click on the "Approve" 
icon. 



Note that you can make further changes to the page and preview it again before checking it into the 
server. You can also preview any page (but not a fragment) by selecting it from the Active List and 
clicking on the "Preview page" button above the Active List. 



id 



Approve document 



To approve the publishing of a fragment or a servable, select it in the Active List and click on the 
"Approve final pages for selected document" icon. This will launch a browser and display a list of all 
resulting HTML pages. For a fragment, the list consists of all final HTML pages of all the servables that 
include the fragment as a subfragment. For a servable, the list consists of all final HTML pages of that 
servable. 



Create problem report 

If you find a problem with a final page, create the appropriate problem report by clicking on the "Create - 
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problem report" icon. 
[^Publish document 

If you find no problems with any of the final pages you are approving, click on the "Publish document" 
icon above the Active List. The selected document will be published to the server. 

Remove current document 

While editing a document in the right-hand pane, you can click on the "Remove current document" icon. 
This will unlock the document on the server and discard the document being edited from the Editor UL 

ACTIONS FOR REGULAR USER 

Get Task List 

Select "Tasks -> Show Task Interface" from the menu bar to retrieve current tasks assigned to you in the 
workflow engine. 

tfilupdate Task List 

To refresh the entries in the Task Dialogue, click on the "Update task list" icon. Note that after you first 
launch the Task Dialogue the tasks do not get automatically updated. You have to explicitly ask for the 
list to be updated. 



Hllnitiate Task 

To begin working on an assigned task, select the task and click on the "Initiate selected task" icon. A 
Create task will open a new document template to fill in, an Edit task will check out an existing 
document, and a Publish task will launch a browser to approve pages to be published. Once you check- 
in or publish the document initiated by a task, the task will disappear from the task dialogue. 



View task info 

To view task associated with a document in the Active List or in the right hand panel, click on the "View 
task associated with selected document" icon. It will bring up the Task Dialogue with the appropriate 
task selected. Note that this icon is only enabled for documents that are associated with a task. 

The other actions you will be able to take in the Franklin Editor UI as a regular editor are described 
above in the superuser section . Allowed actions will be identified by the icons being highlighted. 



